# Codex CLI 自定义模型配置

## 作用

Codex CLI 不需要修改桌面版 `app.asar`，也不需要修改 VS Code 插件文件。它直接读取当前用户的 Codex 配置和模型目录。

配置脚本会先备份本机 `models.json`（如果存在），再使用公司提供的 `models.json` 覆盖本机模型目录；文件不存在时自动创建。随后更新 `config.toml`：

```toml
model_catalog_json = "~/.codex/models.json"
model = "dev-l-0.56x"
```

Provider、服务地址、登录状态和授权信息不会被修改。

## Windows 同事执行

在 Windows PowerShell 中执行下面一条命令。默认使用 GitLab Raw 发布地址；只有发布源变更时才需要替换 URL：

```powershell
irm 'https://gitlab.com/comluojian/agent-tools/-/raw/main/codex/windows/cli/latest/Run-CodexCliSetup-Remote.ps1' | iex
```

脚本要求本机已经安装 Codex CLI，并且 `codex` 命令已经加入 PATH。配置完成后可以验证：

```powershell
codex debug models
```

CLI 可能显示原始模型编号，而不是 `display_name`，这是命令行界面的正常显示方式。模型实际调用编号为：

```text
dev-s-0.56x
dev-t-0.56x
dev-l-0.56x
dev-0.55x
dev-0.54x
dev-m-0.54x
```

桌面版和插件版需要处理本地模型筛选，CLI 不需要这一步。CLI 升级后通常不需要重新打包；如果配置目录被重置，再执行同一条命令即可。

## macOS 同事执行

在 macOS 终端中执行：

```sh
curl -fsSL 'https://gitlab.com/comluojian/agent-tools/-/raw/main/codex/macos/cli/latest/Run-CodexCliSetup.sh' | sh
```

该入口更新 `~/.codex/models.json` 和 `~/.codex/config.toml`，默认模型为 `dev-l-0.56x`，会保留服务地址、Provider、登录状态和授权信息。要求已安装 Codex CLI、`curl` 和 `python3`。

## 恢复官方模型

如果需要退出公司模型配置，执行下面的一条命令：

Windows：

```powershell
irm 'https://gitlab.com/comluojian/agent-tools/-/raw/main/codex/windows/cli/latest/Run-CodexOfficialRestore-Remote.ps1' | iex
```

macOS：

```sh
curl -fsSL 'https://gitlab.com/comluojian/agent-tools/-/raw/main/codex/macos/cli/latest/Run-CodexOfficialRestore.sh' | sh
```

恢复命令会备份并移除 `model_catalog_json`，将默认模型设置为 `gpt-5.5`；Provider、服务地址、授权信息和其他配置保持不变。完全退出当前 CLI 会话后重新启动。